home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / dev / e / rpmod1v1.lha / RPMOD1V1.DOC
Encoding:
Text File  |  1995-04-06  |  4.9 KB  |  172 lines
  1.  
  2.     support modules 1 V1.0
  3.  
  4.     © Richard Perrott 6th April 1995 FreeWare
  5.       email: hcm94rp2@dmu.ac.uk
  6.  
  7.     RPMOD1V1.LHA
  8.  
  9.     This archive contain a number miscellaneous modules
  10.     all compiled using ECDEMO V3.0. + some AREXX scripts
  11.     for CygnusEd Pro V2.11.
  12.  
  13.  
  14. filename    Compile Date    Routine Name    Description
  15. -----------    ------------    ------------    -----------
  16. bcpl.m        06 Apr 1995    bptr        convert a BPTR to normal pointer
  17.                 cptr        convert a normal pointer to a BPTR
  18.                 bstr        convert BSTR to C string
  19.                 bptrc        normal pointer version of bstr
  20.                 bstrCmp        compare two BSTR
  21.                 bstrCmpc    normal pointer version of bstrCmpc
  22.  
  23. log2int.m    13 Mar 1995    log2int        Log2(n) for INT
  24.  
  25. log2long.m    13 Mar 1995    log2long    Log2(n) for LONG (68000)
  26.  
  27. log2log020.m    13 Mar 1995    log2long    Log2(n) for LONG (68020+ only)
  28.  
  29. putchars.m    04 Apr 1995    putchars    fill ARRAY OF CHAR
  30.  
  31. putints.m    04 Mar 1995    putints        fill ARRAY OF INT
  32.  
  33. putlongs.m    04 Apr 1995    putlongs    fill ARRAY OF LONG
  34.  
  35. qsort.m        04 Apr 1995    qsort        Generalized QuickSort
  36.  
  37. qsortSL.m    06 Apr 1995    qsortSL        FAST! QuickSort for
  38.                         signed ARRAY OF LONG
  39.  
  40. qsortUL.m    06 Apr 1995    qsortSL        FAST! QuickSort for
  41.                         unsigned ARRAY OF LONG
  42.  
  43. AREXX scripts for CygnusED Pro 2.11+
  44. ------------------------------------
  45. * Requirements
  46.  
  47.   OS 2.0+
  48.     (you are crazy if you don't have at least this by _NOW_)
  49.  
  50.   RxGen.library in libs:        (not included)
  51.     ALL library interface for AREXX and on Aminet.
  52.  
  53.   DOS.rxfd (OS2.0 updated) in REXX:    (included (OS3.0 version) )
  54.  
  55. * If you want the update the other files for RxGen get this.
  56.  
  57.   Native Developer User Kit for the FD files to update dos.rxfd to OS2.0+.
  58.     ftp: ftp.rz.uni-wuerzburg.de/pub/amiga/frozenfish/bbs/cbm/NDUK-v??.lha
  59.     (e.g. for V2.0 get NDUK-v37.lha, for V3.0 get NDUK-v39.lha)
  60.  
  61.  
  62. * Scripts
  63.  
  64. doEC.ced
  65.     Does the following:
  66.         fixes some common (mine) mistakes;
  67.         saves file;
  68.         splits the 'view';
  69.         calls the compiler;
  70.         parses error text;
  71.         marks any error with 'Mark location 1';
  72.         shows status in an OKAY1 requester.
  73.  
  74.     Where the return code for the byte position is suspect then 'Mark
  75.     location 2' is used to mark the given line number.  Only if there
  76.     are no errors will the view unsplit.  In the 'OKAY1' requester
  77.     all the details from the error / PASS are displayed formatted and
  78.     any ANSI formatting codes removed.
  79.  
  80.     You will probably need to change some or all of the following
  81.     variables:
  82.       'flush',
  83.         the path/filename for flushlib or '' if you don't want to
  84.         use it, I use it to stop the dumb module cache keeping old
  85.         and version of module(s) when the compiler had compiled new
  86.         version(s) of the module(s) since.
  87.       'compiler',
  88.         the path/filename for the compiler;
  89.       'option',
  90.         the compiler options, don't use ERRBYTE or ERRLINE;
  91.       'log',
  92.         the path/filename for the error file;
  93.       'log2'
  94.         the path/filename for the return code file;
  95.  
  96.  
  97. openEmodule.ced
  98.     Calls ShowModule and caches the result in a directory in RAM:  in
  99.     case it is called again for the same module then loads the text
  100.     file in a new window.
  101.  
  102.     You will need to change variable 'compiler' to the path/filename
  103.     for the compiler.
  104.  
  105.  
  106.  
  107.     Notes
  108.     -----
  109. All the modules in here are Freeware, but are not allowed to be used in
  110. commercial software except with my permission by snail mail or PGP signed
  111. email (when I get PGP installed that is!).  Anyone who wants the source
  112. code ?Wouter?  should email me.
  113.  
  114.  
  115.  
  116.     Glossary
  117.     --------
  118.  
  119. BCPL
  120.     a language that was used to write AmigaDOS 1.0..1.3 by Metacomco
  121.     that originated at Cambridge University, England. The language
  122.     is no longer used for writting AmigaDOS, C is used instead.
  123.     Unfortunately we are stuck for compatability reasons with several
  124.     structures and library routines which still use and require BCPL
  125.     formatted addresses and strings.
  126.  
  127. BCPL string
  128.     an array of characters in multiples of 4, the 1st character
  129.     holds the length of the string and the remainder the string
  130.     itself. Typically pointed to by a BPTR.
  131.  
  132. BPTR
  133.     a BCPL pointer base on LONGs rather than CHAR
  134.     e.g. CPTR = $001A3460, BPTR = $00068D18
  135.  
  136. BSTR
  137.     a BPTR to a BCPL string.
  138.  
  139. CPTR
  140.     a normal memory address.
  141.  
  142.  
  143.     Planned Modules
  144.     ---------------
  145. 1.    An integer square root using the _fast_ method (the same
  146.     method explained in an old issue of BYTE magazine for cube roots
  147.     etc) _not_ Newton-Raphson divide by 2 method.
  148.     No I'm not a maths nut, I pinched it from the forth source code
  149.     and the hardware manual for the NOVIX RISC processor, figure that
  150.     out if you can!
  151.  
  152.  
  153.     Thanks
  154.     ------
  155.  
  156. CygnusSoft & ASDG for CygnusEd Pro 2.11, still the best editor
  157.  
  158. Amiga and the Commodore(/ex) engineers and programmers for the best
  159. computer and the best fully multi-tasking OS.
  160.  
  161. Blizzard for the wickedly fast Blizzard 1230 III 50MHz Accelerator card for
  162. the A1200.
  163.  
  164. William S. Hawes for ARexx, I couldn't do without it.
  165.  
  166. Martin Korndörfer for Magic Menu.
  167.  
  168. De Montfort University Milton Keynes, for finally getting on the net in
  169. January 1995, pity it has to be PCs (many crashes, mad-tasking Windows).
  170.  
  171. And finally you for reading this tripe, he he, enjoy :-))
  172.